Barcode Xpress for .NET v13 - Updated
How to Register an Automatically Reported Runtime License (Node-Locked)
User Guide > Licensing and Distributing > Runtime Licensing > How to Register an Automatically Reported Runtime License (Node-Locked)

Automatically Reported Runtime licenses use a mechanism similar to Toolkit licensing to activate a license for a particular system. In this case, each installation has a unique license that is pulled from the pool of licenses purchased by the customer. When the license key is generated, it contains hardware information that identifies the system on which the license is to be installed. 

The Licensing Development Kit (LDK) component, which interacts with the licensing web service and installs the newly generated license key, may be used directly by the application or it may be used through a simple tool known as the Server Licensing Utility (SLU). 

 

This section provides information about the following:

License Pools

When Automatically Reported Runtime licenses are purchased, they are organized into pools of a specific version and platform for a particular toolkit.  For example, if a customer developed two applications using Barcode Xpress, one using 32-bit ActiveX and the other using .NET, they would purchase two pools of Runtime licenses, one for the ActiveX platform and one for the .NET platform.

At installation, a new license would be pulled from the appropriate pool, depending upon which platform the application is using.

License Configuration Files

When an Automatically Reported Runtime license is purchased, a License Configuration file is created and distributed to the customer along with their assigned Solution Name and Solution Key.

The License Configuration file contains information about the Runtime licenses for a particular platform and version of a toolkit. It is used by the Server Licensing Utility or License Development Kit to activate licenses when the customer’s application is installed on their users' systems.

Licensing API

The Licensing API is used in the developer’s code to specify Runtime Licensing deployment information. This is used to unlock the Accusoft products and enable all licensed features at runtime. Both the "Solution Name" and "Solution Key" values used in the API described below are provided by Accusoft, along with the License Configuration file, at the time of purchase of a Runtime license.

Solution Name

The Solution Name is the name assigned by Accusoft to the licenses purchased for runtime deployment. It is a character string that is set for a component prior to use in a deployment environment and is typically the name of the organization that purchased the Runtime licenses. It is set via the SetSolutionName method of the component’s Licensing class. For example:

 
Copy Code
BarcodeXpress bx = new BarcodeXpress();
bx.Licensing.SetSolutionName("ACMEImaging");

The Solution Name must be set in order to use runtime licensing.

Solution Key

The Solution Key is a set of four numbers assigned when the licenses are purchased for runtime deployment; the Solution Key also identifies the organization that purchased the Runtime licenses. The Solution Key is set via the SetSolutionKey method of the component’s Licensing class. For example: 

 
Copy Code
BarcodeXpress bx = new BarcodeXpress();
bx.Licensing.SetSolutionName("ACMEImaging");
bx.Licensing.SetSolutionKey(0x1C3A023F, 0xA018F260, 0x37AF0E51, 0x557F2389);

The Solution Key must be set in order to use runtime licensing. 

SLU vs. LDK

Both the SLU and the LDK perform the same function of registering the Runtime license for the system on which it will be run. The SLU is a user interface for the LDK. Both are provided in order to give you some options.

When installing the license, the user you are running as must have Administrator access so that the Registry can be accessed and the license can be added to the system.

 

See Also